Markdown简明教程

您所在的位置:网站首页 vscode markdown导出pdf不显示公式 Markdown简明教程

Markdown简明教程

2023-06-03 19:39| 来源: 网络整理| 查看: 265

Markdown简明教程

文章目录 Markdown简明教程前言准备工作基础语法标题语法目录语法强调语法列表语法分割线语法引用语法链接语法表格语法 进阶语法HTML语法转义语法公式语法代码块语法绘图语法脚注语法复选框语法Emoji语法 后记

前言

在你使用Word或者Pages的时候一定遇到这样的情况:在自己的电脑上排版好的文件,发到别人的电脑上,排版就被打乱了。这时候先别忙着砸电脑,因为学了Markdown之后,或许能解决你的这一烦恼。

什么是Markdown? Markdown.pngMarkdown 是一种轻量级标记语言那么,什么叫做标记?举个简单的例子:老师拿到期末考试的成绩单后,用绿色记号笔标记出前十名的同学,用红色记号笔表标记出后十名的同学。被绿色记号笔标记的同学没有暑假作业,被红色记号笔标记的同学暑假作业超级加倍,而没有被标记的同学只需要完成普通数量的作业就可以了。在这个例子中我们可以看到,通过不同的标记可以得到不同的结果,而“普通的”则不需要被标记。在Markdown中也是类似的,当你需要给某些文本加上特殊的格式时,你就需要在文本的附近加上标记,而那些普通格式的文本,则不需要添加任何标记。现在,你已经大致明白了什么是标记,那么接下来,我们一起认识各种标记分别代表什么意思吧!

准备工作

老师在开始批注之前,必须有一张成绩表。你得知自己被标记为红色,想要给老师写检讨书,以求高抬贵手时,也需要先在电脑上安装一个Word。

类似的,我们在使用Markdown之前,也需要一个Markdown的编辑器。我比较推荐VScode(免费)当然你也可以使用网页版的编辑器,例如马克飞象等。等你学会之后也可以使用Typora(付费)、MarkText(目前免费)和Obsidian(免费,但是在Markdown的基础上加了一些新的语法),因为这两个编辑器在默认模式下不显示Markdown代码,而是直接显示效果,因此对初学者而言不是十分友好。

值得一提的是,不同编辑器使用的解析引擎可能并不相同,或者使用了同一解析引擎的不同版本,导致在不同编辑器上Markdown的语法可能稍有不同,不过差距不会很大(这一现象被称作“方言”)。因此我比较推荐使用较为大众的编辑器,因为很多小众的编辑器可能对Markdown的支持不是很好。

基础语法 标题语法

在文本前添加井号(#)标记,则这串文本变成了标题,你可以通过控制井号(#)的数量来控制标题字号的大小,一个井号(#)号则是一级标题,两个#号则是二级标题以此类推。一共六级标题。

Markdown代码效果# 一级标题一级标题## 二级标题二级标题### 三级标题三级标题#### 四级标题四级标题##### 五级标题五级标题###### 六级标题六级标题

考虑到“方言”,可以在井号(#)和文字之间添加一个空格,从而应对编辑器兼容问题。

其实标题还有另外一种语法,但是比较麻烦,这里不做介绍了。学有余力的同学可以去查阅资料,自行学习。

目录语法

在需要插入目录的地方用键盘打上“[TOC]”(引号不用打上,方括号和字母都必须有,其中方括号在英文输入法里才能打出来,在下文中,我也会类似的将需要用英文输入法的符号用红色标出),编辑器就会根据标题语法自动生成目录。

当读者点击目录时,就可以跳转到这篇文章相应的地方。

强调语法

斜体:在需要倾斜的文本两端加上一个星号(*)标记或者一个下划线(_)标记;

粗体:在需要倾斜的文本两端加上两个星号(**)标记或者两个下划线(__)标记;

加粗斜体:在即需要加粗,又需要倾斜的文本两端加上三个星号(***)标记或者三个下滑线(___)标记。

Markdown代码效果这是一段倾斜的文字这是一段倾斜的文字这是一段倾斜的文字这是一段倾斜的文字这是一段加粗的文字这是一段加粗的文字这是一段加粗的文字这是一段加粗的文字这是一段加粗且倾斜的文字这是一段加粗且倾斜的文字这是一段加粗且倾斜的文字这是一段加粗且倾斜的文字 列表语法

有的教程也叫做“清单”,只是叫法不同,实质上是同一种东西

无序列表:在每一项前面加上星号(*)、加号(+)或者减号(-)紧跟一个空格来创建无序列表.

Markdown代码:

周一周二周三

或者

周一周二周三

效果:

周一周二周三

效果:

周一周二周三

使用加号(+)创建无序列表与之类似,此处不再演示。

有序列表:在每一项前面加上一个数字并紧跟一个英文句点和一个空格创建有序列表。数字可以不按照顺序排列,但是第一个数字不能随便写,因为第一个数字代表了列表的起始序号。

Markdown代码:

周一周二周三

或者:

周一周二周三

或者:

周一周二周三

第一个数字规定了列表的起始序号:

周一周二周三

效果:

周一周二周三

效果:

周一周二周三

效果:

周一周二周三

效果:

周一周二 周一

注意:由于“方言”的原因,有的地方会正常显示(如下)

周一周二周三 然而有的地方则会乱码,因此我并不建议你用1以外的其他数字作为有序列表的开头,这样既符合大多数人的认知习惯,也能提高你的代码的可迁移性。

嵌套列表:在上述列表的基础上,添加一个制表符(键盘上的TAB键),呈现出包含关系。

Markdown代码:

周一 上午高等数学计算机基础中午下午周二周三

效果:

周一上午 高等数学计算机基础 中午下午周二周三 分割线语法

在单独的一行上输入三个或三个以上星号(***)、减号(—)或者下划线(___)。

Markdown代码:

—或者***或者___

效果:

引用语法

块引用:在文本前添加一个大于号(>)标记。

考虑到“方言”,可以在大于号(>)和文字之间添加一个空格,从而应对编辑器兼容问题。

Markdown代码:

这是一个块引用

效果:

这是一个块引用

嵌套块引用:再问本前添加两个大于号(>>)就是二层引用,三个大于号(>>>)就是三层引用,以此类推。

Markdown代码:

这是第一层引用

这是第二层引用

这是第三层引用

效果:

这是第一层引用

这是第二层引用

这是第三层引用

链接语法

网站链接:将需要添加链接的文本放到一对方括号内([ ]),网址放到一对圆括号(( ))内,如果需要添加链接的title,可以在方括号内增加一对双引号("")将title放到双引号当中,title是当鼠标悬停到带有链接的文本上时显示的文字。当然title不是必须添加的,在合适的时机添加title可以获得更好的效果。

Markdown代码:

马克飞象

注意:由于“方言”,可以在前双引号的前面添加一个空格。

效果: 马克飞象

这时候,你点击“马克飞象”四个字,就可以跳转到对应的网站了。

有时需要直接添加一个网站链接,而不是为文本添加链接,这时候可以把网址放到一对尖括号(< >)当中,你要叫它小于号和大于号也行,随你高兴。

Markdown代码:

效果: https://maxiang.io/

这时候,你点击这段网址就可以直接跳转到对应的网站了。

图片链接:要在文章中链接一个图片,其实和网站的链接是类似的,只不过,链接图片时,需要在代码前添加一个感叹号(!)。

Markdown代码:

[图片名称](这里放上图片在你的电脑上的地址,此处不再演示 “你也可以添加title”) 这样可以链接到本地的图片

[图片名称](这里放上图片的网站链接,此处不再演示 “当然,你也可以添加title”) 这样可以链接到网站上的图片

效果: Markdown图片.png [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kPd299md-1684331958176)(Markdown%E5%9B%BE%E7%89%87.png#id=GvDqf&originalType=binary&ratio=1&rotation=0&showTitle=true&status=done&style=none&title=%E4%BD%A0%E4%B9%9F%E5%8F%AF%E4%BB%A5%E6%B7%BB%E5%8A%A0title “你也可以添加title”)] Markdown.png [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-d34LXVFF-1684331958177)(https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fmikemclin.net%2Fmmwp%2Fwp-content%2Fuploads%2F2013%2F03%2Fmarkdown-syntax-language.png&refer=http%3A%2F%2Fmikemclin.net&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1671616608&t=f270f83d0658c380e52da2b95d1f1a4b#id=tUz7H&originalType=binary&ratio=1&rotation=0&showTitle=true&status=done&style=none&title=%E5%BD%93%E7%84%B6%EF%BC%8C%E4%BD%A0%E4%B9%9F%E5%8F%AF%E4%BB%A5%E6%B7%BB%E5%8A%A0title “当然,你也可以添加title”)]

表格语法

创建表格:用或者号~~(我暂时没有查到这个符号叫什么名字,就暂且叫它或者号吧,因为C语言里面,两个这个符号就表示“或者”)~~(|)来分割列,用多个减号(-)来分割表头和其他行。

Markdown代码:

| 姓名| 年龄 | | ------| ----- | | 张三| 3 | | 李四 | 25 | | 翠花 | 60 |

效果:

姓名年龄张三3李四25翠花60

对齐:如果将分割表头和其他行的减号换成(:—)、(:—:)、(—:)则分别可以实现左对齐、居中对齐、右对齐等效果(冒号在那边,就向那边对齐)

Markdown代码:

| 姓名| 年龄 | | ------😐 :-----: | | 张三| 3 | | 李四 | 25 | | 翠花 | 60 |

效果:

姓名年龄张三3李四25翠花60 进阶语法 HTML语法

看完基础语法之后,你就会发现,Markdown中并没有控制字体颜色的语法,那么上文中英文标点用红色标出是如何做到的呢?这是因为Markdown对HTML语法有很好的支持,在Markdown中可以直接使用HTML语法,来设置字体的颜色、大小、字体等等。HTML不属于本篇文章主要讨论的问题,此处不再过多展开。如果你不会HTML的话,你可以关注我的博客,我以后有可能会写相关的教程

转义语法

在标记前加上一个反斜杠(\),这个标记就会失去作用,不被编辑器解析。转义生效后,反斜杠会被自动隐藏,不会影响本文的外观。

Markdown代码:

*这一段文字不会被加粗,因为使用了转义语法*

这一段文字会被加粗,因为没有使用转义语法

效果:

这一段文字不会被加粗,因为使用了转义语法

这一段文字会被加粗,因为没有使用转义语法

公式语法

行内公式:在公式的两边各加上一个美元符号($)

Markdown代码:

质能方程: E = m c 2 E=mc^2 E=mc2

氢气燃烧:KaTeX parse error: Undefined control sequence: \ce at position 1: \̲c̲e̲{H_2 + Cl_2 ->[…

效果:

KaTeX parse error: Undefined control sequence: \ce at position 20: …:E=mc^2\\ 氢气燃烧:\̲c̲e̲{H_2 + Cl_2 ->[…

由于“方言”,在有的地方公式不能正常展示。

块公式:在块公式的上面一行和下面一行各加上两个美元符号($$)

Markdown代码:

&& f(x)= \begin{cases} x+2 , x0 \end{cases} &&

效果:

f ( x ) = { x + 2 , x < 0 2 , x = 0 x − 2 , x > 0 f(x)= \begin{cases} x+2 , x0 \end{cases} f(x)=⎩⎪⎨⎪⎧​x+2,x0​

由于“方言”,在有的地方公式不能正常展示。

由于篇幅有限,且数学、化学符号太多,无法完全展示。如果你想要深入了解,可以关注我的博客,我之后有可能会写一篇相关的合集。

代码块语法

行内代码:如果只需要在一行中插入代码,用一对反引号()将代码包裹起来即可

Markdown代码:

在C语言中经常使用i++让i的值递增

效果:

在C语言中经常使用i++让i的值递增

块代码:如果需要插入多行代码,可以在代码块的上面一行和下面一行同时使用三个反引号(```)或者三个波浪号(~~~)。同时第一行的三个反引号后边应标注上代码快使用的语言。

Markdown代码:

//那我就随便写几个Bug,给大伙儿助助兴。 [[include]] int eat(); void study(); double sleep(); int main() { while(alive){ eat(); study(); sleep(); } return 0; }

> > 效果: > > > ```c //那我就随便写几个Bug,给大伙儿助助兴。 #include int eat(); void study(); double sleep(); int main() { while(alive){ eat(); study(); sleep(); } return 0; }

代码只是演示作用,不要太较真。

使用波浪号与之类似,此处不再演示。

如果你会Mermaid,甚至可以用来绘制流程图。mermaid不是本篇文章讨论的重点,此处不在过多赘述。如果你恰好不会的话,可以顺便关注一下我的博客,我之后可能会写一篇相关的教程。

绘图语法

Mermaid.jpg 在Markdown中使用Mermaid可以绘制流程图、时序图、类图、状态图、甘特图、饼图、思维导图……涉及到地内容太多,这里不过多赘述,可以前往Mermaid官方教程学习。或者关注我的博客,我会在之后写一篇有关Mermaid的教程。

脚注语法

脚注:为文本添加脚注,可以帮助读者理解比较深奥、难懂的内容。在需要添加脚注的位置打上一对方括号([ ]),并且在方括号内打上插入符号(^)和标识(标识可以是数字或者文字,由于“方言”有的编辑器可以用中文作为标识,但是绝大部分编辑器都不支持,因此我比较建议你使用英文或者数字作为标识)。

注释:一般情况下,编辑器默认会在文章末尾生成对应的注释,不过并不是必须将注释添加到文章末尾,你可以在文章的任何地方打上一对方括号([ ]),并且在方括号后打上一个冒号(:),在方括号内打上插入符号(^)和标识(注释的标识必须和脚注的标识一一对应)

当读者点击脚注,就可以跳转到注释的地方,再点击注释处的箭头,又可以跳转回到脚注的地方。或者当读者将鼠标悬停在脚注上时,就会显示对应的注释。

Markdown代码:

爱因斯坦在1896年10月进入苏黎世理工学院[^1],攻读数学和物理师范专业。

效果:

爱因斯坦在1896年10月进入苏黎世理工学院[1],攻读数学和物理师范专业。

除此之外,还可以将需要添加脚注的文本用方括号([ ])包裹起来,并且在方括号后添加一对圆括号(( )),在圆括号内添加注释(和上文中的链接语法类似,也可以打上一个双引号(" ")来作为注释的title)

Markdown代码:

爱因斯坦在1896年10月进入[苏黎世理工学院](苏黎世联邦理工学院(英语: ETH或ETH Zurich),由瑞士联邦政府创建于1854年,爱因斯坦母校,与姊妹校洛桑联邦理工学院一起组成瑞士联邦理工学院,是瑞士联邦经济事务、教育与研究部的一部分,坐落于瑞士苏黎世。ETH作为IDEA联盟、全球大学高研院联盟、国际研究型大学联盟、全球大学校长论坛等一系列联盟成员,专注于工程与技术和自然科学领域,被誉为"欧陆第一名校"。——来自百度百科 “苏黎世理工学院”),攻读数学和物理师范专业。

复选框语法

在文本前添加一个减号(-)和一对方括号([ }),并且在方括号前、中、后各加一个空格。在方括号中输入x(大小写均可),就可以选中这个复选框。

写法如下:-空格[空格]空格文本

由于方言,不同编辑器对复选框语法的理解不同,在有的编辑器上打出减号后的空格时,就自动生成了无须列表。这时候可以尝试先打出后两个空格,最后再打出第一个空格。

Markdown语法:

和小张约会

和小王约会

[ ]和 小丽约会

效果:

和小张约会 和小王约会 和小丽约会 Emoji语法

你可以直接使用输入法来输入Emoji表情,不过由于方言,并不是所有编辑器都支持你这么做。因此,我更建议你通过,在表情简码的两边各加上一个冒号(:)来输入Emoji表情。

这里展示几种常用的表情简码,觉得不够用的同学可以自行上网搜索。

Markdown代码Emoji表情: smile :😄: laughing :😆: joy :😂: scream :😱: sunny :☀️: rainbow :🌈: car :🚗: video_game :🎮: girl :👧 后记

现在恭喜你,又掌握了一项新技能,Markdown很简单,但是却可以创造很多不简单的事。

希望你以后能勤加练习,早日熟练Markdown。让它能成为你前进路上,记录灵感、倾诉心情的知心朋友。

苏黎世联邦理工学院(英语: ETH或ETH Zurich),由瑞士联邦政府创建于1854年,爱因斯坦母校,与姊妹校洛桑联邦理工学院一起组成瑞士联邦理工学院,是瑞士联邦经济事务、教育与研究部的一部分,坐落于瑞士苏黎世。ETH作为IDEA联盟、全球大学高研院联盟、国际研究型大学联盟、全球大学校长论坛等一系列联盟成员,专注于工程与技术和自然科学领域,被誉为“欧陆第一名校”。——来自百度百科(这时候再点击这个剪头就可以回到刚才的位置) ↩︎


【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3